[Introduction]---------

hello all.

This is a set of simple little programs included in this package. They all have a simple and basic function and should perform them quite well.

Their are 3 main programs, they are Clear.jar and shutdown.jar.

Clear.jar is a short program that will empty the system clipboard compleatly, it is will suscfully empty it untill a test for clipboard items comes up empty, so this is ensured to ALWAYS empty the clipboard every time. It uses a few dialog boxes to output any messages, which include if the clipboard is already empty or to tell you when it has been emptied. 


shutdown.jar is a more complex program, this will ask the user for a password, every incorrect password OR the timmer running out will use a try. Their is a set number of trys that can be used, after all trys have been used then it will shutdown the computer to stop it from being used. This also has the function to empty the clipboard every set amount of time, to try and stop the unwelcomed user from useing the copy, cut or paste functions.

It will recognise 2 passwords, one will disable the timmer and exit the program, the other will allow you to add more time to the counter. Both of these passwords and all other settings are stored inside history.csv. If this file is missing then it will revery back to defult values.

This NEEDS the Encoder.csv to work, without this it cant encode your password to check agenst the encoded password. Feel free to edit the encoder, BUT if your settings file wont load then you cannot run the defult passwords to exit the program if you have changed the encoder. The process of encoding is nesacary as to stop people from just finding the password in a file and typeing it in.


settings.jar is another program that you can run to set the settings file up, if it is lost or if you want to edit any settings. This program will take your normal password that you have entered and will encode it for you for it to be saved in the settings file. I highely recomend that you delete this file after use, and re downloade it if you need to edit any settings, or see section about settings file.


activator.jar is the last one of the main programs, and it is used to keep a HDD active. This is needed as if a HDD is left inactive for a cirtian amount of time then it will stop spining. This means it will take longer to respond to you when you need it, and it can also shorten the life span of the HDD. This will keep it active for you.

It works by writing a value to a .txt file (you specfie where it is, i recomend making a new file as it will replace anything in a pre excisting file) every set amount of time for you. You can add multiple files to allow you to keep more than 1 HDD active at a time. To keep them clean as well, this can delete the files when it closes, so that you dont have random .txt laying about the place. Remember it is pointless to have 2 files on 2 partitions on the same HDD as they are both keeping the same HDD active. 


ALL PROGRAMES REQUIRE JAVA TO BE INSTALLED. IF YOU DONT HAVE JAJA PLEASE GO TO: www.java.com/getjava/




[Files and Instlation]---------

Clear.jar			Program
settings.jar			Program
shutdown.jar			Program
activator.jar			Program
SystemClipboard.jar		Helper Code
Encoder.csv			Encoder Set
history.csv			Settings and History (shutdown.jar and settings.jar only)
Folders.txt			Settings (activator.jar only)
HDDLogo.png			Picture
shutdownLogo.png		Picture
HDDLogo.ico			Icon (your use only)
shutdownLogo.ico		Icon (your use only)
README.txt			Help File


To install please copy all of the files listed above to any location on your computer. They MUST be in the same folder for the program's to work. logo.ico and README.txt are not needed in the running of the program, and can be deleted. 

To run any program double click on the corsponding .jar file. SystemClipboard.jar will NOT run, this is used by the other programes and must be keept for shutdown.jar and Clear.jar to work.

To make starting the programs easier, i recomend creating shortcuts (right click - send to - desktop(create shortcut) ) and then you can use the corsponding .ico to set the icon to the shortcut (for win 7, right click - propties - change icon - browse - find and select '.ico' file - ok - ok). 


To unistall, simpily just remove all of the files above and delete any shortcuts that you have made. To fully remove any files that activator.jar has created, I recomend clicking 'Remove' for every file, and acepting the file delete.



[Encoder.csv File]---------

This is a file that is used by the built in encoder, it is by defult a set of 62 characters in 2 rows. The top row is the original letter (letter to be replaced) and the bottom row is the new letter (letter replacing it). This will match the letters from their colums. Without this file, shutdown.jar and settings.jar will not work. 

Feel free to edit this file as much as you want, just do NOT repeat any characters. This is not fixed to 62 enterys long, feel free to add any more characters that you wish to encode, including punctiation. Devide every character with a ',' and do not try to encode a ',' for this reason.

If the character is not in the encoder file then the program will still run, it will leave the character as its original character. 


[history.csv File]---------

This is a simple little file that saves some varibles that the program will use, including an encripted version of the passwords. I recomend useing settings.jar to edit this file, if you have deleted it after use and dont want to get it again, then bellow i will explain what each entery is.

0,0,3,20,1,5,0,5PU5,Jxx,171,244,186, 0, 0


In order from left to right they are:

suscfull_uses			- Number of suscfull attempts to date, shown on program end.
failed_uses			- Number of failed attempts to date, shown on program end.
number_of_tries			- Number of password attempts before computer will shutdown.
time_seconds			- The time used on the build in countdowner.
time_between_cliboard_wipe	- The time intervals between every System Clipboard wipe.
level_of_encription		- The level of encription that the passwords will be stored in.
time_mode			- The way the built in countdowner will work. 0 = time per try. 1 = total time given.
deactivation_password		- The encripted password to deactivate the program and advoide a shutdown.
add_time_password		- The encripted password to add more time to the countdowner.
red_componet			- The RED componet of the RGB colour background used.
green_componet			- The GREEN componet of the RGB colour background used.
blue_componet			- The BLUE componet of the RGB colour background used.
system_tray			- Enabled (1) or disabled (0) the system tray icon.
miminise_to_tray		- Enabled (1) or disabled (0) minimising to system tray only is system tray is enabled.


The password can contain any character you want, apart from a ',' as this will confuse the code too much. All numbers should be a whle number and postive, if not then the shutdown.jar file might instantly shutdown your computer. If you use settings.jar then it will ensure that all variables you entered are valid.




[Folders.txt File]---------

This is the settings file for activator.jar and it works across multiple lines. The length of this document changes as you add or remove files for activator.jar to use. The fixed aspect of the layout is as followed.


1				- Enabled (1) or disabled (0) the system tray icon.
1				- Enabled (1) or disabled (0) minimising to system tray only is system tray is enabled.
0				- Enabled (1) or disabled (0) starts minimised to the system tray.
171,244,186			- R,G,B color to be used.
0.0				- Time from startup before Auto-Closing the program. 0.0 disables the feature.

Their can then be multiple of lines bellow this, which are in 3's. The layout for each set of 3 is as followed.

30.0				- Time between file writes in seconds. If value is too large then HDD might stop spining.
1				- Enabled (1) or disabled (0) removing the file when the program is closed.
file:/K:/test.txt		- Location of the file in mention. 

The first 4 settings can ONLY be edited through this file. ALL of the other settings should be edited through the program to ensure a smooth running. 




[Change Log]---------

{v1.0}

	- Program realise - shutdown.jar, settings.jar, Clear.jar.

{v1.1}

	- Added converting Miniutes and Hours to Seconds.
	- Added handling for decimal numbers in settings.jar.
	- Added checking for incorrect values in all type boxes in settings.jar.
	- Added a new time mode (total time till shutdown).
	- Added a way to change the background color to custmise the program.
	- Added a button to settings.jar that will create a pre made Encoder.csv for you.
	- Edited how the encoder works, so it can now handle any punctiation (not fixed length Encoder.csv).

{v1.2}

	- Fixed bug with timmer on shutdown.jar.
	- Fixed bug unencoding a password containing the first letter on the Encoder.csv.
	- Added defult button to settings.jar and shutdown.jar (enter button now performs a defult action).
	- Added auto focus to main text boxes in settings.jar and shutdown.jar (selected on startup).
	- Reduced file sizes of settings.jar and shutdown.jar.

{v1.3}

	- Program realise - activator.jar.
	- Added new settings file and logo for activator.jar.
	- Added automatic time conversion for settings.jar.
	- Added system tray support for shutdown.jar with full settings (enabled/disabled and minimise to tray).
	- Added miniutes and seconds to the time left diaplay in shutdown.jar.
	- Fixed incorrect text display for time left in shutown.jar (now changes with time_mode).
	- Edited how the background image is displayd in shutdown.jar so it keeps its aspect ratio.